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INTRODUCTION 



OVERVIEW 

SKETCHPAD is a drawing tool for creating designs on your ATARI Home Computer* You use a 
Joystick Controller to position a cursor in the drawing area of the TV display* Then you 
type one- and two-letter commands in a command window to specify the design element* The 
program has 25 commands for drawing* coloring* and merging designs* You can draw points* 
lines* boxes* circles* lines radiating from a common point* and solid areas* You can 
create mirror images of designs in several ways — from left half to right half* upper half 
to lower half* or within the drawing area's four quarters* You can change the hue and 
intensity of four pen colors (one background and three foreground)* All the colors in 
ATARI BASIC'S 128-color palette (16 hues and S luminosities) are available, but your 
design displays in only four colors at a time* You can copy the design elements in one 
area to another area* and you can merge a design on the screen with one stored on 
cassette or diskette* 



REQUIRED ACCESSORIES 

ATARI BASIC Language Cartridge 
One ATARI Joystick Controller 

Cassette tapes or DOS 2-formatted diskette(s) for staring pictures 
Cassette version 
16K RAM 

ATARI 410 Program Recorder 
Diskette version 
24K RAM 

ATARI 810 Disk Drive 



CONTACTING THE AUTHOR 

Users wishing to contact the author about SKETCHPAD may write to him at: 

^509 Triana Boulevard* Lot ?^ 
Huntsville* AIab3M3 35805 



GETTING STARTED 



LOADING SKETCHPAD INTO COMPUTER MEMORY 

1* Insert the ATARI BASIC Language Cartridge in the cartridge slot of your computer* 

2* Plug the Joystick Controller into the first (leftmost) controller jack at the front of 
the computer console* 

3* If you have the cassette version of SKETCHPAD? 
a* Have your computer turned off* 

b* Slide the SKETCHPAD cassette into the program recorder's cassette holder and 
press REWIND on the recorder until the tape rewinds completely* Then press PLAY to 
prepare the program recorder for loading the program* 

c* Turn on the computer while holding down the START key* 

d* When you hear a beep, release the START key and press the RETURN key* SKETCHPAD 
will load into computer memory and start automatically*- 

Note* A beep sounds after the title page displays* indicating that the main program 
loading has begun* You needn't press the RETURN key this time* 

If you have the diskette version of SKETCHPAD : 

a* Turn on your disk drive* 

b* When the BUSY light goes out* open the disk drive door and insert the SKETCHPAD 
diskette with the label in the lower right-hand corner nearest to you* Close the 
door* 

c* Turn on your computer and TV set* The program will load into computer memory and 
start automatically* 



FIRST DISPLAY SCREEN 

The display screen contains a black drawing area with a pink cross-hair cursor in the 
upper quarter and a blue command window at the bottom of the screen* A status line at the 
top of the command window indicates the initial position of the cursor* N(40*20), and the 
initial pen* (PI)* 



SAMPLE SESSION 



Use this sample session to become familiar with some of SKETCHPAD'S features. Read each 
command's notes before executing the command* Type in the commands exactly as they appear 
(except for TRIGGER, which is explained below) and press the RETURN key after each 
command* 

The screen origin (0,0) is at the upper left-hand corner of the drawing area* The 
x-coordinate goes from 0 to 159 across the screen; the y-coordinate goes from 0 to 79 
down the screen* Control the cross-hair cursor by moving the Joystick in the direction 
you want to move the cursor (hold the Joystick with the trigger button to your upper 
left)* Cursor movements are represented in the sample session as: 

TRIGGER (x f y) 

When you have the cursor positioned at the specified x-y location* press the trigger 
button (pressing the RETURN key isn't necessary in these cases)* 



COMMANDS . 
TRIGGER (40,20) 



NOTES 



TRIGGER (50,20) 



TRIGGER (50*20) 



P2 

TRIGGER (60,10) 
TRIGGER (60,10) 

TRIGGER (40,10) 



across 



The status line at the top of the 

coM«and window indicates the cursor is 40 coluMns 
the drawing area and 20 rows down the drawing 
area — N(4Q,20)* It also indicates you're using F :, en 1* 
F'ress the TRIGGER button without Moving the cursor* 
You'll hear a "click" ♦ 

Now use the Joystick to Move the cursor horizontally 
to the right* When the status line displays "(50,20)", 
press the TRIGGER button* The programs draws an ORANGE 
line froM (40,20) to (50,20)* 

Now we want to draw another line segment 
that's attached to the ORANGE one we just drew* To do 
so, press the trigger again at (50,20) without Moving 
the cursor, to specify the starting point of the next 
segMent ♦ 

We'll change to pen 2, which is green, 

before Moving to the end point of this segMent of the 
1 ine * 

Move the cursor to (60,10) to draw a GREEN line* 

Press TRIGGER again at the saMe location to 
start another segMent* 

Move the cursor to (40,10) to draw the third 
segMent* 
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Change to pen 3 to draw in BLUE: ♦ 

Activate the CIRCLE: coMnand* 

Notice the word CIRCLE in inverse video 

in the status line of the coMMsnd window, and the profit 
following the line* The prompt is asking you to position 
the cursor at the location where you want the center of 
the circle* Press the TRIGGER button without Moving the 
cursor to center the circle at (**Q*10)* 

Another prompt now asks you to position the 
cursor at the coordinate location where you want the 
outer edge of the circle to extend* Move the cursor to 
position (^0*0) ♦ and press the trigger button to cause 
the program to draw a SOLID BLUE CIRCLE ♦ 

Change back to pen 1 in ORANGE ♦ 

Activate the BOX command* 

A prompt appears below the status line 
asking you to position the cursor where you want the 
lower left-hand corner of the box* Move the cursor to 
(60*33) and press the trigger button* 

Now a prompt asks you to position the cursor 

at the upper right-hand corner of the box* Move the 

cursor to (70*22) and press the trigger button* 

Change all design elements of the current pen (PI) 
from the current color (ORANGE) to LIGHT PURPLE (H5)« 

Now change to the background pen, which is 0* 

Change the background to HARD BLUE* a hue (H) of 7* 

Change to pen 3* 

Change all BLUE to RED* 

Darken the red by lowering the intensity 
with the I command* 

Change to pen 2* 



Darken the green of pen 2* 



Display the new values of all the pens with the 

D coMMand* After you check these values* press the 

RETURN key to return to command Mode* 

Leave SKETCHF : 'AD ♦ 



This example uses only 8 of the 25 available commands, but you now have some background 
and experience for reading the details in the next sections, which describe all the 
commands* 



COMMANDS 



INTRODUCTION 
Entering commands 

Type all SKETCHPAD commands on the computer keyboard, and press the RETURN key after each 
command* Some commands display prompts requesting you either to enter more information 
from the keyboard or to position the cursor and then press the Joystick's trigger button* 

Command mode 

You can enter commands only when you're in command mode* which is the normal mode of 
SKETCHPAD* In command mode* you see the pink crass-hair cursor in the drawing area and 
the status line indicates you're in one of the symmetric modes (explained below)* 

When you start the program, the status line readst 

N<40 ,2Q)P1 

The "K" indicates you're in "no symmetry" mode. "(40,20)" indicates the current location 
of the cursor* "PI" indicates you're using pen 1* The rest of the command window is 
blank, which also denotes command mode* When you activate a command, the name of the 
command displays in the status line and any accompanying prompts display on the following 
line* The format of the status information is! ~ " * 

<syMMetry Mode> ( k > y ) P<pen nufiber > 

Symmetry mode is indicated by one of these single letters; 

B design elenent syrwetric about both axes 

N no syfinetry 

X design elenent syMMetric about X-centerline 

Y design element symmetric about Y-center line 

Pen number is indicated by one of these digits* 

0 Initial color is BLACK (background) 

1 Initial color is ORANGE 

2 Initial color is GREEN (intensity of the? letters 
in the connsnd window) 

3 Initial color is BLUE (also coMwend window color) 

Figure 1 approximates the initial display* 



+ < — cursor 

DRAWING AREA 



coMMsnd input/pronpt 1 ine 



Figure 1 SKETCHPAD Display 



Screen Dimensions 



The origin (0,0) of the axes is at the upper left corner of the drawing area* The x-axis 
goes from left to right, and the y-axis from top to bottom, as shown in Figure 2» 



0,0 — > X 



159,0 




0*79 159,79 
Figure 2 Screen Dimensions of Drawing Ares 



Cursor position and symmetry 

Each symmetry mode limits you as to the drawing area in which you may move the cursor* 
The mode and permitted area are as follows: 

B — the upper left quarter of the drawing area 
N — the entire drawing area 
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X — the upper half of the drawing area 
Y — the left half of the drawing area 

When you're working in a limited area, each item you draw is mirrored in the remainder of 
the screen* 

You can change the symmetry mode at any time you're in command mode without changing the 
elements already drawn on the screen* 

Entering screen coordinates 

You specify x-y coordinates required for a command by moving the cursor around the screen 
with your Joystick and then pressing the trigger button until you hear a "click", which 
indicates the current position of the cursor has passed to the command* Each time you 
press the trigger button* you'll hear the click through the computer console's speaker* 

The longer you move the cursor in a direction, the faster it travels* This acceleration 
is canceled when you put the Joystick back in "neutral", that is, when you stop moving 
the cursor* This feature lets you move the cursor across the width of the screen in less 
than five seconds* 
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LINES AND POINTS 



You can draw lines and points very simply by positioning the cursor at a point and then 
pressing the trigger button* To draw a point, you press the trigger button twice at the 
same cursor location ♦ To draw a line, first you position the cursor at the starting point 
and press the trigger button* Then you reposition the cursor at the ending point and 
press the trigger button again* 

You can draw a line string by triggering the starting point of the second line of the 
segment at the same location as the ending point of the first line* The steps are as 
follows! 

Position cursor at start of line string 
TRIGGER st3rt point 

Position cursor 3t end of first segment 
TRIGGER end point of first segment 
TRIGGER start of second segment 
Position cursor at end of second segment 
TRIGGER end point of second segment 
TRIGGER start of third segment 
Position cursor at end of third segment 
TRIGGER end point of third segment 



TRIGGER start of last segment 
Posiion cursor at end of last segment 
TRIGGER end point of last segment 



Erasing lines 

To erase a line* 

1* Use the PO command to change to the background pen color* 

2* Redraw the line in the same direction * 

3* Change the pen color back to the previous one* 
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B - DRAW A BOX 



Use the B command to draw solid boxes* The command prompts you For two paints that 
describe the box's diagonal, extending from the lower left-hand corner to the upper 
right-hand corner* 



1 +- 



Position the cursor at the appropriate location and enter the paints by pressing the 
Joystick trigger button* A prompt displays for each point: 

1 - TRIGGER LLC (lower left-hand corner) 

2 - TRIGGER URC (upper right-hand corner) 

The B command ignores the case of a box with a zero-length diagonal (that is* bath paints 
are triggered at the same location)* Actually ♦ this command works with any diagonal. You 
can specify the diagonal left to right* top to bottom, and so on, as long as it's a 
diagonal* 
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C - DRAW A CIRCLE 



Use the C command to draw solid circles* The command prompts you for two points 
describing the circle's center point and radius! 



Enter the two points by positioning the cursor at the appropriate location and pressing 
the Joystick trigger button* A prompt displays for each point: 

1 - TRIGGER center point 

2 - TRIGGER radius 

The C command ignores the case of the circle with a zero-length radius (that is, bath 
points are triggered at the same location)* 

To overcome the "vertical stretch" characteristic of TV screens, the circle is scaled* 
That is* circles drawn by SKETCHPAD are 20 percent wider than they are tall* Increasing 
the width of circles drawn gives them a more circular appearance* If you specify the 
radius of circles horizontally from the center, they'll be wider than your edge point 
(point 2 in the diagram above) specified by 20 percent* If you specify the radius 
vertically from the center, the circle will pass through the edge point and not beyond it* 
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CS - CLEAR SCREEN 



Use the CS command to clear the screen without affecting the current pen, the current 
screen mode, the pen colors, or the cursor position* This command has no prompts* 



D - DISPLAY PEN COLOR VALUES 



Use the D command to check the current pen colors* SKETCHPAD has an initial color for 
each pen* If you use the D command to display these initial colors, the information looks 
like this: 

PO PI P2 P3 

0 2 12 9 HUE 

0 8 10 ^ LUM ♦ 

press RETURN to exit? 

For each pen number (PO, PI, P2, P3>, the display indicates the hue number (HUE) and the 
intensity (LUM*)* The display remains on the screen until you press the RETURN key to 
return to command mode* 

See the Intensity (I) and Hue (H) commands for descriptions of hue and luminosity values* 
Also see the Display Reference Page (M) command for a TV display summarizing the hue and 
intensity settings of all pens* 
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DD - DISK DIRECTORY 



Use the DD command to display a complete diskette directory in the same format as that 
used by DOS 2*0S* See Chapter 4 of the Disk Operating System II Reference Manual for a 
complete explanation of the directory* This command displays the directory only for disk 
drive 1 (DT*)* and it doesn't apply to cassette-only systems* 

Once the directory displays on the screen* the prompt: 

press RETUF*<N to exit? 

displays fallowing the directory* The directory listing remains on the display screen 
until you press the RETURN key* After you locate the file name you're looking for* press 
the RETURN key and then use the R or W commands to read from or write to your desired 
file* 

If the directory listing is longer than the display screen area* the display will scroll* 
causing the file names to disappear off the top of the screen* You can stop the scrolling 
temporarily by holding down the CTRL key and pressing "l", and then releasing both keys* 
To continue the display* repeat the CTRL-1 sequence* 
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E - DRAW AH ELASTIC LINE STRING 



Use the E command to draw lines that radiate from a common point* The points defining the 
line string are as follows! 

o 4 

o 3 

o 5 

o 2 

o 1 

Position the cursor at the center point (1) and press the Joystick trigger* All following 
points will connect from the center point to the triggered cursor location* as 
illustrated above* The two prompts displayed are* 

1 - TRIGGER center point 

2 - TRIGGER next point 

End elastic string mode by triggering twice at the last point* 
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F - FILL AN AREA 



Use the F command to fill areas with the current pen color* The F command displays these 
prompts: 

1 - TRIGGER start point 

2 - TRIGGER end point 

After you position the cursor at the start and end points and trigger each point, the 
area bounded vertically by the start and end points right fills , line by line* Fill is 
done on each line defined by these two points to the right* until a colored area is 
encountered, or until the fill wraps around the screen and meets the starting point* At 
each point* the fill command then begins to fill the next line* and so on, until the line 
with the end point has been filled* 

The fill command doesn't obey your current symmetry mode* You must fill symmetric figures 
in individual segments. Also, this command doesn't fill the line the starting point is on* 
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H - CHANGE THE COLOR (HUE) OF CURRENT PEN 



Use the H command to change the color of your current pen* This command is a single-line 
command* H#* where "# M is the number representing the color to which you want to change 
your current pen* The values of the hue number are: 



nir 


LULU r\ 




L?r sy 


1 

X 


l. J. g n T/ urdnye 


2 


Orange 


3 


Red-orange 




Pink 


5 


Purple 


6 


Purple-blue 


7 


Blue 


8 


Blue 


9 


Light blue 


10 


Turquoise 


11 


Green-blue 


12 


Green 


13 


Yel low-green 


14 


Orange-green 


15 


Light orange 



The H command changes the color of all items drawn on the screen in the current pen 
color* This limitation is a hardware characteristic* Change a pen color as follows} * 

1* Use the P command to select the pen for which you want to change the color (e*g»* F3)* 

2* Use the H command to change the pen's color (e*g** H12)* 

The intensity of the hue is controlled by the I command* 
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I - CHANGE COLOR INTENSITY (LUMINOSITY) 

Use the I command to change the intensity of all items drawn on the screen in the current 
pen color. This command is a single-line command, I#, where "#" is an even integer 
between 0 and 14, The values and meanings of the luminosity number are as follows*. 

I* BRIGHTNESS 



0 D3rkest 
2 

6 
8 

10 
12 

14 Brightest (off-white) 

Change the intensity of a pen color as follows? 

1. Use the P command to select the pen for which you want to change the intensity (e.g., 
P3) 

2. Use the I command to change the pen color's intensity (e.g., 12). 

If the luminosities of pens 2 and 3 are the same, the text in the command window at the 
bottom of the screen will be invisible. This anomaly is a hardware characteristic. 
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K - COPY AN AREA 



Use the K command to copy a rectangular area to another area of the screen* Specify the 
area to be copied by positioning the cursor at the lower left-hand corner and upper 
right-hand corner and pressing the trigger button each timet The prompts displayed are5 

1 - TRIGGER LLC (lower left-hand corner) 

2 - TRIGGER URC (upper right-hand corner) 

Select the destination area by positioning the cursor at the upper left-hand corner of 
the destination rectangle in response to the third prompt and then pressing the trigger 
button* 

3 - TRIGGER target ULC (upper left-hand corner) 

The K command doesn't clip at the screen mode boundaries, regardless of symmetry mode* In 
modes X* Y» and B, overlap can occur if you copy areas near the symmetry axis of the 
screen* You can use this characteristic effectively with the copy methods described in 
the Advanced Commands section* 
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M - DISPLAY REFERENCE PAGE 



Use the M command to obtain an quick reference display of SKETCHPAD commands* When you 
press the M key, SKETCHPAD immediately displays the reference page* Don't press the 
RETURN key* This display contains most of the summary information an the SKETCHPAD QUICK 
REFERENCE SHEET* located at the back of these instructions* The screen display is 
formatted differently owing to space limitations* 

When you've finished checking the reference page, press the RETURN key to redisplay your 
design* J 1 

The M command doesn't work if: 

1* You've activated the D* DD* R, or W commands (because they require keyboard input), or 

2. You've already pressed some other key and SKETCHPAD is waiting for you to complete the 
command and press the RETURN key* 



P - CHANGE DRAWING PEN 



Use the P command to change your current pen* SKETCHPAD provides four pens, which lets 
you create drawings having from one to four colors* The command is a single-line command, 
P#, where is the pen number (0 - 3) you want to use for subsequent drawing. For 
example, type P3 to draw with pen 3* See the Introduction to this section for information 
about initial pen colors* 

The P command is special in that you can use it in command mode, or at any time a prompt 
for input displays* For example, you can enter the P command instead of indicating the 
second point OJRC) for the BOX command to cause SKETCHPAD to change colors* Then you can 
trigger the second point to draw the box in the new pen color* 

The R (Restore display) and W (Save display) commands ignore the P command, because 
changing pen color during these actions has no bearing on the activity* 
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Q - QUIT SKETCHPAD 



Use the 0. command to end your SKETCHPAD session. Once you use the Q command, you can 
restart SKETCHPAD only by turning off your computer and then turning it on again with 
SKETCHPAD in disk drive one. 



R - LOAD DISPLAY FROM CASSETTE OR DISKETTE 

Use the R command to retrieve a previously saved copy (see the W command) of a screen 
display from cassette or a data diskette for viewing or modification. The command 
displays the prompt: 

filename? 

Your response depends on where the screen to be loaded into computer memory resides. 
For screens on cassette, respond withJ 
C 

and press the RETURN key, The prompt 

cue tape- push RETURN 

appears and beeps once to indicate you should place in the program recorder the tape 
containing the screen to be loaded, press PLAY, and then press the RETURN key. After 
about 15 seconds, the screen starts loading on top of the current screen's contents, 
Loading takes about 2 1/2 minutes. Another beep sounds upon completion of the command and 
returns you to command mode. 

For screens on diskette, have your data diskette inserted in the disk drive and then 
respond with the DOS filename (e.g., D1JGARDEN.PIC). Limit your total filename to 15 
characters} otherwise, SKETCHPAD can't locate the file. (DOS allows filenames longer than 
8 characters and simply truncates the name to the first 8 characters. The same procedure 
is true to the 3-character extender. SKETCHPAD doesn't do this.) SKETCHPAD immediately 
begins loading the screen on top of the current screen's contents. The load takes about 
10 1/2 seconds. 

Note. The program interprets the first character of the filename as the device code (D 

for diskette, C for cassette, or S for screen). If you omit the device code and use a 

filename starting with "S", the screen will be read into itself, causing the screen to 

turn one color. If you run into this problem, you'll lose the current picture. If you 

have the diskette version of SKETCHPAD, press the SYSTEM RESET key to reload SKETCHPAD 

into computer memory and continue your work. If you have the cassette version, reload 

SKETCHPAD into computer memory, following the steps in "Getting Started". 
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Sm - SCREEN SYMMETRY MODE COMMANDS 



Control the behavior of the screen while drawing by using the S command* You can change 
symmetry mode during a drawing session, and subsequent drawing will be in the new mode, 
while previous work remains unchanged* The symmetry mode commands are* 

COMMAND DESCRIPTION 



SB Draw synnetr icsl ly about both horizontal and 
vertical center lines 

SN Draw with no syfwetry 

SX Draw synwetr ical ly about the horizontal 
center line 

SY Draw sywnetr ical ly about the vertical 
center line 

The axes have their origin (0,0) at the upper left corner of the drawing area* The x-axis 
runs from left to right, and the y-axis from top to bottom* The maximum screen dimensions 
are 0-159 columns across the screen (the x-axis) and 0-79 rows down the screen (the 
y-axis)* The actual drawing area is determined by the symmetry mode of the screen, as 
shown in Figure 3 below* Characteristics of each mode are as follows* 

B 

The cursor is restricted to 0-79 along the x-asix and 0-39 along the y-axis* Every item 
drawn in this mode is mirrored around the center of the screen to create a bi-axially 
symmetrical picture* 

N 

The cursor can move across the full screen (0-159 along the x-axis and 0-79 alonq the 
y-axis)* What you draw is what you get* 

The cursor is restricted to 0-159 along the x-axis and 0-39 along the y-axis* Every 
item drawn is mirrored about the horizontal center axis of the screen* 

Y 

The cursor is restricted to 0-79 along the x-axis and 0-79 along the y-axis* Every item 
drawn is folded about the vertical center axis of the screen* 
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W - SAVE DISPLAY ON CASSETTE OR DISKETTE 



Use the W command to store a copy of your screen design on a data diskette for future 
use* The command displays the prompt* 

f i ler»3«e? 

Your response depends on the device on which you want to store your screen* 
To save screens on cassette* respond* 

C 

and press the RETURN key* The prompt 

cue tape- push RETURN 

appears and beeps twice to indicate you should place in the program recorder the tape for 
storing the display* press RECORD and PLAY* and then press the RETURN key* After about 15 
seconds* the message* 

DISPLAY BEING SAVED 

displays in the command window and recording begins* Saving a screen takes about 2 1/2 
minutes* A long beep sounds upon completion of the command and returns you to command 
mode* 

For screens on diskette* have your data diskette inserted in the disk drive and then 
respond with the DOS filename (e*g* t Dl*DESIGN*FIO* Limit your total filename to 15 
characters} otherwise, SKETCHPAD can't locate the file* (DOS allows filenames longer than 
8 characters and simply truncates the name to the first 8 characters* The same procedure 
is true to the 3-character extender* SKETCHPAD doesn't do this*) SKETCHPAD immediately 
begins saving the screen on diskette* The saving process takes about 15 seconds* 

The W command saves the fallowing screen settings for later retrieval by the R command: 

1* screen syMMetry Mode 
2* current pen nuMber 

3* all current pen colors (both hue* and luminosity) 

You can save about twenty screens on one diskette* Each picture file requires 26 sectors 
of diskette space* 

Note* The program interprets the first character of the filename as the device code (D 
for diskette* C for cassette* or S for screen)* If you omit the device code and use a 
filename starting with "S"* the screen will be written to itself* causing garbage to 
appear on the screen and the status line to display at the top of the screen* If you run 
into this problem* you'll lose the current picture* If you have the diskette version of 
SKETCHPAD, press the SYSTEM RESET key to reload SKETCHPAD into computer memory and 
continue your work* If you have the cassette version* follow the steps under "Getting 
Started" to reload SKETCHPAD into computer memory* 



ADVANCED COMMANDS 



The advanced commands are extensions of the copy 
command (K) and the read command (R). These extensions 
allow shapes on the screen to interract with other shapes, : 
either on the screen or in a cassette or disk file. The 
interraction is governed by three rules of logic: 

AND - intersection 

OR - union 

EOR - NOT (intersection) 

As a source area is copied to a destination or as a screen 
is read in under control of one of these three rules, 
the rule operates on the two pixels under consideration to 
determine the color of the pixel to be placed on the screen. 

For example, a display may be created and then a 
stored display may be read in under control of the AND rule. 
The first pixel is read from the stored display, and the 
pixel at location (0,0) on the screen is ANDed with it to 
determine the color of the pixel that will be placed at 
location. (0, 0) . Then the second pixel is taken from the 
display and ANDed with the pixel at location (1,0) to make a 
new pixel for that location. This process moves from left to 
right from the top of the screen to the bottom until, the 
entire display is read in from storage and ANDed with the 
screen contents. So, the two pictures are combined, one 
pixel at a time, according to the AND rule. 

The extensions of the copy command work exactly like 
the extensions to the read command, as described above. The 
copy command obtains its input from a rectangular area of the 
screen that is defined by the user of the copy command and 
copies this area according to the specified rule to a 
destination area on the screen. 

These extensions to the R and K commands are invoked by 

Rn -or- Kn 

where n is 

1 to AND the source and the destination pixel 

2 to OR the source and the destination pixel 

3 to EOR the source and the destination pixel 
while SKETCHPAD is in tbe command mode. 



In order to apply these rules for drawing more sophisticated 
displays, you must become familiar with the three tables 
describing the source and destination pixel colors (pen 
color numbers) and pixel color (pen number again) produced 
by the rule. 
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CURSOR CONTROL KEYS 



The three keys on the right-hand side of the console 
that are below the SYSTEM RESET key are used by SKETCHPAD 
to control the cursor color and its speed of motion across 
the screen. 

Color control is handled by the OPTION and SELECT keys. 
The OPTION key will increase the number in the cursor color 
register by 2 for each time it is pressed. The effect of thi 
is to increastthe intensity of the cursor- When pressed 
repeatedly, the intensity of the cursor will increase to its 
maximum, and then bump up to the next color and the lowest 
intensity value for this new color. Pressing the SELECT 
key has the opposite effect — the color value in the cursor 
color register is decreased by two for each press of the 
SELECT key. 

Cursor speed is controlled by the START key. Pressing 
this key once will erase the status display at the bottom 
of the screen. SKETCHPAD is still in command mode but 
the status is not displayed. Pressing this key a second 
time will cause the status line to re-appear. Disabling 
the status line display will speed up cursor motion by 
about 25?o. The only disadvantage to this mode of operation 
is the inability to know where on the screen the cursor is 
(in absolute coordinates), the pen number^ or the current 
screen mode. Since the START key toggles the status line^ 
this isrft a real handicap. 

It may be desirable to photograph.-. thS . Ty -screen . In thi< 
case, it is very handy to be able to turn off the status line 
with the START key to prevent its appearance in the* photo. 



ADVANCED TECHNIQUES 



INTRODUCTION 

Use this section to supplement the basic descriptions in the Command section* You should 
already have read the command descriptions and be generally familiary with command 
operations* This section (1) illustrates novel uses of individual commands—uses not 
necessarily apparent from the basic descriptions in the Command section, and (2) 
describes combinations of commands that provide a capability or feature not available 
through a single command* 



J! 



ADVANCED SKETCHPAD TECHNIQUES 



PRODUCING A SYMMETRIC FIGURE FROM AN ASYMMETRIC ONE 



One major restriction exists. Any assymetric figure 
that is to be made symmetrical must reside in that portion 
of the screen that is accessable in the mode having the 
desired symmetry characteristic. If you want to make a 
figure symmetric about the Y-axis 3 then the assymetric part 
of the figure must have been drawn in the area of the screen 
defined or bounded by (0,0) and (79,79). If this one 
unsurmount able requirement can be met, then the technique 
is straight forward: 

1 - place the screen in the desired symmetry mode, 

2 - activate the K2 command (copy with OR), 

3 - specify thelower right-hand corner as the first 

coordinat ej 

4 - specify the upper left-hand corner as the second 

coordinatej 

5 - specify the target ULC without moving the cursor. 



The effect of this technique is to cause SKETCHPAD to 
copy the asymmetric portion of the figure on top of itself 
and simultaneously mirror the figure about the axis of 
symmetry specified by the screen mode. 

As an example, put the screen in the no symmetry mode 
(SN) and draw a circle with pen one (PI) whose center is 
at (20,20) and whose radius is at (30,20). Us^e the SB 
command to place the screen in the bi-axial symmetry mode. 
Activate the K2 command and specify the source rectangle by 
the coordinates (30,30) and (10,10). Also specify the 
upper left-hand corner of the target rectangle at (10,10). 
SKETCHPAD will mirror the contents of the rectangle about 
both center axes to produce a symmetric figure. Naturally 
this technique will work for more complex figures and can 
also be adapted to produce symmetric fills. 



COLOR FILL FOR COMPLEX SYMMETRIC FIGURES 



One of the problems with producing complex solid 
figures is converting the outlines into solids. One 
method for filling these symmetric figures is to: 

1 - draw the figure in the desired symmetry mode 

using line segments or what everj 

2 - use the fill command (F) to fill in the 

asymmetric portion of the figure, 

3 - activate the K2 command (copy with OR), 

4 - specify the lower right-hand corner as the 

first coordinate^ 

5 - specify the upper left-hand corner as the second 

coordinate > 

6 - specify the target upper left-hand corner without 

moving the cursor. 



Steps three through^ix of this fill technique are 
identical to the steps given for producing symmetric 
figures from asymmetric ones. 



PRODUCING COMPLEX REPETITIVE PATTERNS 



There are two good methods for producing repetitive 
patterns. If the repeat portion of the pattern must be 
symmetrical, the best way to make it is in the center of 
the screen in the appropriate symmetry mode. After the 
repeat portion is completed, place the screen in the no 
symmetry mode and use the K command to copy the pattern 
to the location you want to start the repeating pattern 
at. If the original pattern in the middle of the screen is 
in the way, you can erase it by drawing a box in the background 
color on top of it. Once the pattern has been created and 
placed at the desired location on the screen, Successive 
K commands can be used to repeat the original pattern. 
If the repeat portion of the pattern is not symmetric, 
draw the original at the desired location and just use 
successive K commands to clone it around the screen. 
Typically^ the copying is done in the no symmetry mode. 



SYMMETRIC OVERLAP IN FIGURE CREATION 



The copy command (K) has one distinguishing characteristic 
it does not clip at the screen boundaries. This sometimes 
irritating feature can be used to create complex symmetric 
figures. The general technique is: 

1 - place the screen in no symmetry mode (SN) 

2 - draw a figure in the rectangular area defined by 

(0,0) and (79,39) 

3 - place the screen in bi-axial symmetry mode 

4 - use the K3 command (copy with EOR) to copy this 

figure to a target rectangle located near the center 
of the screen in such a way as to cause the rectangle 
to cross both aXes of symmetry. This causes folding 
to occur and the EOR function will produce 
unexpected results. Figure IV-1 illustrates the 
source and target rectangles. 
Figure ^represents the resulting overlap pattern for 
Figure IV-1. For maximum effect, use all 3 foreground colors 
or pens in the source rectangle. The Kl and K2 commands will 
also produce interesting results when used in this way. 
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SEPARATING MERGED DISPLAYS 
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SKETCHPAD 



DISPLAY STORAGE FORMAT 



All SKETCHPAD 
The format is: 



display files are 3208 bytes long 



byte # 
0 



2-6 

7-3207 



description 

the current pen number (0-3) when the display 
wassaved 

the screen mode (1-4) when the display was 
saved. l=mode X, 2=mode Y, 3=mode B, 4=mode N 
color registers 0-4 

display data for a BASIC mode 7 display (with 
split screen). Pixels are 2 bits wide, packed 
4 to a byte, from left to right. 



A DISK-RESIDENT DISPLAY LOADER ROUTINE 



In order to incorporate a display in an application a method 
to rapidly load the display must be available. This machine-code 
routine is designed to be called from BASIC. Loading a display from 
disk takes about 4% seconds. Here is the assembly listing of the 
display loader routine: 



*=$600 
DSPLOAD 

QUICK LOADER FOR DISK- RE SIDENT 
SKETCHPAD 2.0 FILES 

A= USR( 1536, HUN ,BUF ADR, COUNT) 

WHERE L UN IS THE UNIT NUMBER 
BUF ADR IS THE ADDRESS TO LOAD 
THE SCREEN INTO MEM. AT. TYP. 
ADDRESS IS CONTENTS OF LOC 
88 AND 89 (DECIMAL) -7 
COUNT IS THE NUMBER OF BYTES 
TO LOAD FROM THE DISK. TYPICAL 
IS 3208 DECIMAL. 



GETCH 
ICCOM 
I CB AH 
ICBAL 
ICBLH 
ICBLL 
CIOV 



$07 

$0342 

$0345 

$0344 

$0349 

$0348 

$E456 



BET CHARACTERS 
COMMAND BYTE 
BUFF ADDR MSB 
BUFF ADDR L SB 
BUFF LEN MSB 
BUFF LEN LSB 
CIO ENTRY VECTOR 



REMOVE ARG COUNT 
MUST BE 3 ARGS 

OR QUIT 
REMOVE UNIT NUMBER MSB 
GET UNIT NUMBER LSB 
CONVERT TO INDEX FOR CIO 



PLA 

CMP #3 
BNE EXIT 
PLA 
PLA 
CLC 
ROLA 
ROLA 
ROLA 
ROLA 

TAX ;SAVE FOR INDEX 

L DA //GETCH ;GET BYTES COMMAND 

STA ICCOM, X 

PLA ; GET BUF ADDR MSB 

STA ICBAH,X 

PLA ;GET BUF ADDR LSB 

STA ICBAL, X 

PLA ; GET COUNT MSB 

STA ICBLH, X 

PLA ; GET COUNT LSB 

STA ICBLL, X 

JSR CIOV ; READ IN DISPLAY 
EXIT RTS 



A DISPLAY LOADER DEMO PROGRAM IN BASIC 



Here is an AT AR I BASIC program that uses the display loader 
routine ( DSPLOAD) to read in a display from drive one. The displa 
file is named »D1 : DREAMS . PI C" . You should substitute the name of 
a display that exists on one of your disks for this filename that 
appears in line 20. 

5 GOSUB 500 
10 GRAPHICS 7 

12 FOR X=708 TO 712:P0KE 0,X:NEXT X 
20 OPEN #1 ,4,0,"D1 :DREAMS.PIC" 
30 B=PEEK(88)+256*PEEK(89)-7 
AO A=USR(1536,1 ,B,3208) 

In nTl2r' F ^ R A = B+2 T ° B+7:P0 ^ X,PEEK(A) :X=X+1:NEXT A 
60 CLOSE it 1 

70 STOP 

500 FOR U = 1536 TO 1573:RE.AD A : POKE U,A:NEXT U : RET URN 

1000 DATA 104 201,3,208,32,104,104,24,42,42,42,42,170,169,7,157,66 

1002 DATA 157,68,3,104,157,73,3,104,157,72,3,32,86,228,96 



AN EXPLANATION OF THE DISPLAY LOADER DEMO PROGRAM 



LINE 5 - calls the subroutine that will load the machine- code 
display loader routine (DSPLOAD) into memory. This 
machine-code is relocatable- it may be loaded anywhere 
in memory without affecting it. 



LINE 
LINE 

LINE 

LINE 



LINE 
LINE 



LINE 
LINE 
LINE 



10 
12 

20 

30 



40 
50 



60 
70 



using 



LINES 



-put the screen in mode 7 with split screen 
-put a zero in all 5 of the color registers. This has 
the affect of blacking out the screen during the load, 
-open the appropriate file for read-only access 

an unit number (1-5) 
-calculate the load address for the display file. This 
formula is based on the undocumented fact that memory 
locations 88 and 89 decimal will always contain the 
the LSB and MSB of the address of the start of the display 
data (the actual screen information or pixels). Seven 
is subtracted from this address because seven bytes of 
information precede the pixel information in the display 
file on disk. Refer to section 6. This works because in 
graphics mode 7 96 unused bytes separate the display 
list (ANTIC instructions) from the display data. The 
seven information bytes are going to be loaded into the 
unused area, 
-call DSPLOAD to read in the display 

-copy the last five of the seven header bytes into the 
color registers. These are the actual colors of the 
display that was read into memory. Now the display is 
visible. P00F! 
-close the display file 
- s t op 

500-load the 37 byte machine-code routine into memory starting 
at hex address $0600 (1536 decimal). It can actually 
be loaded anywhere. 
1000 and 1002 — the data statements representing the machine 
code DSPLOAD routine. 



Note that the first argument in the DSPLOAD call is the address of the 
routine and must be the same as the value used as the beginning index 
of the FOR loop in line 500. The second argument in the DSPLOAD call 
is the unitnumber used in the OPEN and CLOSE statements (20 and 60). 



A DISPLAY VIEWER FDR DISK-RESIDENT DISPLAYS 



(VIEW does not exist on the cassette version) 

The VIEW program (Dn5VIEW*BAS) is a more elaborate extension of the demonstration program 
DSPLOAD*BAS* VIEW expects you to type in the name of the diskette file you want to display 
(pressing the RETURN key after the file name). Use the full DOS syntax: Dn5ffffffff*xxx ♦ To 
use VIEW, you'll need to load in DOS 2*0S from a diskette other than the SKETCHPAD diskette; 
for example, use the DOS 2 .OS Master Disktte, Insert the DOS 2*0S diskette in the disk drive, 
turn off your computer, and then turn it back on* When the READY prompt displays, load 
VIEW*BAS into computer memory with the command: 

RUN "Dn: VIEW ,8 AS" 

where n is the number of the drive that the program is on* VIEW knows the more common errors 
and will respond with English explanations for the ones it knows* If you make an error in the 
file name, you may use the cursor control keys to move up and correct the file name instead of 
retyping it. After correction, press the RETURN key as usual* 

The actual loading logic is represented a little differently here than it was in DSPLOAD*BAS* 
In VIEW an .additional routine, a BASIC one this time, does the reading in* This BASIC routine 
calls the machine-code routine (DSPLOAD) and additionally does error handling for the input 
file name* The file name resides in the string array F$ * An error flag—A— is returned to the 
main routine* If A is 0, then no error was detected? if A is not 0, then an error was detected 
and acted upon by the basic routine* The variable B is expected to be set by the main routine 
to the buffer address for reading in the screen* The variable X is the only scratch variable 
used by this routine (lines 200 through 230)* 

The next page contains a complete listing of the VIEW program* To use VIEW to read in the 
three demonstration programs provided on the SKETCHPAD diskette, follow these steps: 

1* Insert a diskette with DOS 2*0S on it (do not use the SKETCHPAD diskette for this 
purpose) and then load DOS 2*0S into computer memory by turning off the computer and 
turning it on again* 

2* Re-insert the SKETCHPAD diskette, containing the VIEW*BAS program* 
3* When the READY prompt displays, type 

RUN "DntVIEW.BAS" 

4* Now you can look at any of the three demonstration pictures by entering its file name* You 
can look at only one display at a time* For example, type 

On: DREAMS* PIC 

Have fun! 
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5 DIM F$(16):0PEN #2,12 0 "E-" 
10 GOSUB 500:GRAPHICS 7 ' 
15 B=PEEK(88)+256*PEEK(89)-7 
20-? HI ;"n PICTURE VIEWER " 

In L # ^" ENTER DISK FILE NAME":F$ = »»:l NPUT #2-F$ 
30 IF F$="" THEN 20 ff ,h * 

35 ,r «;;m E H A „ E TOO L0NC - FORMAT TS 

37 IF F$(1,1)=»Q" THEN CLOSE #2:D0S 



THEN ? 
A THEN 25 



#2;"PLEASE ENTER A DISK FILE NAME ' 



40 IF F$(l,l)<>' 
GOTO 25 

45 GOSUB 200:IF 
50 GOTO 20 
200 TRAP 250 
205 OPEN #1,4,0, F$ 

210 FOR X=708 TO 712 :POKE X,0:NEXT X 
215 A=USR(1536, 1,8,3208) 

2 2 25° CLOS 0 ^//! 0 " A = B + 2 T ° B + 7:P0KE X,PEEK(A):X =X+ 1:NEXT A:A = 0 

230 TRAP 40000:RETURN 
250 TRAP 230 
255. A=PEEK(195) 
260 IF A=130 THEN ? 
265 IF A=138 THEN ? 
267 IF A=160 THEN ? 
270 IF A=165 THEN f 
GOTO 225 

275 IF A=170 THEN ? 
280 ? #2 ; "ERROR - 



#2;"N0 SUCH DEVICE":GOTO 225 
#2;"MAKE DISK READY": GOTO 225 
#2;"DRIVE NUMBER IS TOO BIG":GOTO 225 
#2;»IMPR0PER FILE NAME- PLEASE TRY AGAIN" 



f 2 i"2.°r!c? H » FILE: - PLEASE TRY AGAIN" :GOTO 225 
500 FOR U=l 5 3rT0 1 & : ReT P K^ ^SlTcOTO 225 

1002 DATA 157,68,3,104,157,73,3,104,157,72,3,32,86,228,96- 
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OVERRIDING STORED DISPLAY COLORS 



When you're combining stored displays experimentally, it can be annoying to have to reset 
the colors continually after loading a display that uses colors other than those you want 
in your resulting display ♦ The R commands (R, Rl, R2, and R3) provide a method for 
loading in a display while retaining the colors you've set up* Follow these steps to 
override the stored display colors: 

1* Activate the R, Rl, R2, or R3 command* 

2* Type in the name of the file or device to load from without pressing the RETURN 

he* 

3* Hold down the trigger button on the joystick and press the RETURN key* 

4* When you see the display loading on the screen, release the trigger button* 

This procedure overrides the stored display colors only, not the stored symmetry mode or 
current pen number* 
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QUICK REFERENCE SHEET 



CQMM A N DJ3 UMMARY 

COMMAND DESCRIPTION 

B Draw 3 box 

C Draw a circle 

CS Clear the screen 

D Display the pen colors 

DD Display disk directory 

E Draw a radial line string (to exit* TRIGGER 

twice without Moving) 

F Fill 3n area 

H# Change hue of current pen 

I* Change intensity of current pen 

K Copy a source area to a destination area 

Kl Copy a source area, AND ins with the destination 

K2 Copy a source area* OR i rig with the destination 

K3 Copy a source area* EORing with the destination 

M Display reference page 

P# Change pen 

Q Quit SKETCHPAD 

R Load a display froM cassette or diskette 

Rl Load a display, ANDing with the current screen 

R2 Load a display, ORing with the current screen 

R3 Load a display, EORing with the current screen 

SB Change screen syMMetry Mode to B (both axes) 

SN Change screen synwetry Mode to N (no syMMetry) 

SX Change screen syMMetry Mode to X (x-axis) 

SY Change screen syMMetry Mode to Y (y~axis) 

W Save a display on cassette or diskette 



(Note* is a nuMher , e*g*, H12, 16, P3) 

HUE NUMBERS INTENS ITY NUMBERS 



H# 


Color 


I* 


Brightness 


b 


Gray 


0 


Darkest 


i 


Light orange 


2 




2 


Orange 






3 


Red-orange 


6 


♦ 




Pink 


8 


♦ 


cr 
w 


Purple 


10 


♦ 


6 


Purp le-blue 


12 


♦ 


7 


Blue 


14 


Br ightest 


8 


Blue 




(off-white) 


9 


Light blue 






10 


Tur quoise 






11 


Green-blue 






12 


Green 






13 


Yel low-orange 






1* 


Orange-green 






15 


Light orange 







LIMITED WARRANTY ON MEDIA AND HARDWARE ACCESSORIES* 



We, Atari, Tnc*, guarantee to you, the original retail purchaser, that the medium on 
which the AFX program is recorded and any hardware accessories sold by APX are free from 
defects for thirty days from the date of purchase* Any applicable implied warranties, 
including warranties of merchantability and fitness far a particular purpose, are also 
limited to thirty days from the date of purchase* Some states don't allow limitations on 
a warranty's period, so this limitation might not apply to you* If you discover such a 
defect within the thirty-day period, call APX for a Return Authorization Number, and then 
return the product along with proof of purchase date to APX* We will repair or replace 
the product at our option* 

You void this warranty if the APX product: (1) has been misused or shows signs of 
excessive wear} (2) has been damaged by use with non-ATARI products} or (3) has been 
serviced or modified by anyone other than an Authorized ATARI Service Center* Incidental 
and consequential damages are not covered by this warranty or by any implied warranty* 
Some states don't allow exclusion of incidental or consequential damages* so this 
exclusion might not apply to you* 



DISCLAIMER OF WARRANTY AND LIABILITY ON COMPUTER PROGRAMS* 

Most APX programs have been written by people not employed by Atari, Inc* The programs we 
select for APX offer something of value that we want to make available to ATARI Home 
Computer owners* To offer these programs to the widest number of people economically, we 
don't put APX products through rigorous testing* Therefore, APX prad«ts are sold "as is", 
and we do not guarantee them in any way* In particular, we make no warranty, express or 
implied, including warranties of merchantability and fitness for a particular purpose. We 
are not liable for any losses or damages of any kind that result from use of an APX 
product* 



ATARI PROGRAM EXCHANGE 



REVIEW FORM 



We're interested in your experiences with AFX programs and documentation, both favorable and 
unfavorable* Many software authors are willing and eager to improve their programs if they know 
what users want* And, of course, we want to know about any bugs that slipped by us, so that the 
software author can fix them* We also want to know whether our documentation is meeting your needs* 
You are our best source for suggesting improvements! Please help us by taking a moment to fill in 
this review sheet* Fold the sheet in thirds and seal it so that the address on the bottom of the 
back becomes the envelope front* Thank you for helping us! 

1 ♦ Name and APX number of program 

2* If you have problems using the program, please describe them here* 



3* What do you especially like about this program? 



4* What do you think the program's weaknesses are? 



5* How can the catalog description be more accurate and/or comprehensive? 



6* On a scale of 1 to 10, 1 being "poor" and 10 being "excellent", please rate the following 
aspects of this program? 

Easy to use 

User-oriented (e»g*, menus, prompts, clear language) 

Enjoyable 

Self-instructive 

Useful (non-game software) 

Imaginative graphics and sound 



7* Describe any technical errors you found in the user instructions (please give page numbers)* 



8* What did you especially like about the user instructions? 



?♦ What revisions or additions would improve these instructions? 



10» On a scale of 1 to 10 f 1 representing "poor" and 10 representing "excellent", how would you 
rate the user instructions and why? 



11» Other comments about the software or user instructions! 



ISTAMP1 



ATARI Program Exchange 
Attn: Publications Dept* 
P.O. Box 50047 
60 E* Plumeria Drive 
San Jose, CA 95150 



[seal here] 



